From 55071b5bd9d21ac86059e28f21e70f8c8768c1d2 Mon Sep 17 00:00:00 2001
From: Brad Jorsch <bjorsch@wikimedia.org>
Date: Tue, 16 Sep 2014 13:47:34 -0400
Subject: [PATCH] Add API output skin

The API output for help and 'fm' formats will soon have need of
including ResourceLoader modules on an otherwise-bare page. The easiest
way to do this is to use OutputPage, but that requires a skin. So let's
add a skin that outputs a basic page without any navigation elements or
other chrome (that may be added later, but that can wait for Design to
decide they want to design it).

Change-Id: Ifa95fae5acaa3cfbf2ca58a15f8d0c51d84b455a
---
 includes/AutoLoader.php            |  2 ++
 includes/Setup.php                 |  5 +++
 includes/skins/SkinApi.php         | 41 +++++++++++++++++++++++
 includes/skins/SkinApiTemplate.php | 52 ++++++++++++++++++++++++++++++
 4 files changed, 100 insertions(+)
 create mode 100644 includes/skins/SkinApi.php
 create mode 100644 includes/skins/SkinApiTemplate.php

diff --git a/includes/AutoLoader.php b/includes/AutoLoader.php
index d79b2b1120..609b46a24b 100644
--- a/includes/AutoLoader.php
+++ b/includes/AutoLoader.php
@@ -947,6 +947,8 @@ $wgAutoloadLocalClasses = array(
 	'MediaWikiI18N' => 'includes/skins/SkinTemplate.php',
 	'QuickTemplate' => 'includes/skins/SkinTemplate.php',
 	'Skin' => 'includes/skins/Skin.php',
+	'SkinApi' => 'includes/skins/SkinApi.php',
+	'SkinApiTemplate' => 'includes/skins/SkinApiTemplate.php',
 	'SkinException' => 'includes/skins/SkinException.php',
 	'SkinFactory' => 'includes/skins/SkinFactory.php',
 	'SkinFallback' => 'includes/skins/SkinFallback.php',
diff --git a/includes/Setup.php b/includes/Setup.php
index 78a41d5d98..c6c94b7ca1 100644
--- a/includes/Setup.php
+++ b/includes/Setup.php
@@ -286,8 +286,13 @@ call_user_func( function () use ( $wgValidSkinNames ) {
 	$factory->register( 'fallback', 'Fallback', function () {
 		return new SkinFallback;
 	} );
+	// Register a hidden skin for api output
+	$factory->register( 'apioutput', 'ApiOutput', function () {
+		return new SkinApi;
+	} );
 } );
 $wgSkipSkins[] = 'fallback';
+$wgSkipSkins[] = 'apioutput';
 
 if ( $wgLocalInterwiki ) {
 	array_unshift( $wgLocalInterwikis, $wgLocalInterwiki );
diff --git a/includes/skins/SkinApi.php b/includes/skins/SkinApi.php
new file mode 100644
index 0000000000..064c076b91
--- /dev/null
+++ b/includes/skins/SkinApi.php
@@ -0,0 +1,41 @@
+<?php
+/**
+ * Extremely basic "skin" for API output, which needs to output a page without
+ * the usual skin elements but still using CSS, JS, and such via OutputPage and
+ * ResourceLoader.
+ *
+ * Created on Sep 08, 2014
+ *
+ * Copyright © 2014 Brad Jorsch <bjorsch@wikimedia.org>
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License along
+ * with this program; if not, write to the Free Software Foundation, Inc.,
+ * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
+ * http://www.gnu.org/copyleft/gpl.html
+ *
+ * @file
+ */
+
+/**
+ * SkinTemplate class for API output
+ * @since 1.25
+ */
+class SkinApi extends SkinTemplate {
+	public $skinname = 'apioutput';
+	public $template = 'SkinApiTemplate';
+
+	public function setupSkinUserCss( OutputPage $out ) {
+		parent::setupSkinUserCss( $out );
+		$out->addModuleStyles( 'mediawiki.skinning.interface' );
+	}
+}
diff --git a/includes/skins/SkinApiTemplate.php b/includes/skins/SkinApiTemplate.php
new file mode 100644
index 0000000000..be77c617ee
--- /dev/null
+++ b/includes/skins/SkinApiTemplate.php
@@ -0,0 +1,52 @@
+<?php
+/**
+ * Extremely basic "skin" for API output, which needs to output a page without
+ * the usual skin elements but still using CSS, JS, and such via OutputPage and
+ * ResourceLoader.
+ *
+ * Created on Sep 08, 2014
+ *
+ * Copyright © 2014 Brad Jorsch <bjorsch@wikimedia.org>
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License along
+ * with this program; if not, write to the Free Software Foundation, Inc.,
+ * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
+ * http://www.gnu.org/copyleft/gpl.html
+ *
+ * @file
+ */
+
+/**
+ * BaseTemplate class for the 'apioutput' skin
+ * @since 1.25
+ */
+class SkinApiTemplate extends BaseTemplate {
+
+	public function execute() {
+		$this->html( 'headelement' ) ?>
+
+		<div class="mw-body" role="main">
+			<h1 class="firstHeading">
+				<span dir="auto"><?php $this->html( 'title' ) ?></span>
+			</h1>
+			<div class="mw-body-content">
+				<?php $this->html( 'bodytext' ) ?>
+			</div>
+		</div>
+
+		<?php $this->printTrail() ?>
+		</body></html>
+
+	<?php
+	}
+}
-- 
2.20.1